Release 10.1A: OpenEdge Development:
Progress 4GL Reference

DELETE( ) method

Deletes an item from a combo box, radio-set, or selection list.

Return type: LOGICAL

Applies to: COMBO-BOX widget, RADIO-SET widget, SELECTION-LIST widget

Combo-box and Selection-list Syntax

DELETE ( list-index | list-item )

list-index

An INTEGER expression that specifies the ordinal position of a value in the combo box list or selection list.

list-item

A character-string expression that specifies a single value or a delimiter-separated list of values in the widget.

The DELETE( ) method removes the item specified by list-index, or removes the specified list-item from the list. list-item can represent multiple items. For example, you might specify DELETE( "Chicago, Boston, New York" ), where the delimiter is a comma. The delimiter is a comma by default or is specified by the DELIMITER attribute. If the method is successful, it returns TRUE.

Radio-set syntax

DELETE ( label )

label

A character-string expression that specifies an item to delete from the radio-set.

The DELETE( ) method deletes the item from the radio-set, whose appearance changes depending on the user interface and the setting of the AUTO-RESIZE attribute. For all user interfaces, if AUTO-RESIZE is TRUE, the remaining items collapse toward the top to fill the gap left by the deleted item. If AUTO-RESIZE is FALSE in Windows, the remaining items are repositioned to evenly span the original radio-set dimensions; in character interfaces, the remaining items collapse upward as when AUTO-RESIZE is TRUE.

If the method is successful, it returns TRUE.

Note: A single call to DELETE can delete one or more items from a combo box or selection list, or one item from a radio set.